Invalidate

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODFacet

Invalidate
The Invalidate method marks the specified area in this facet as in need of updating.
void Invalidate (in ODShape invalidShape, 
                 in ODCanvas biasCanvas);
invalidShape
A reference to the shape object defining the area in this facet that needs updating, expressed in frame coordinates.
biasCanvas
kODNULL if the geometry is in platform-normal coordinates, otherwise a reference to the canvas object to whose coordinate space the geometry is biased.

DISCUSSION
OpenDoc calls this method. This method transforms and clips the shape from the coordinate space of this facet to the coordinate space of its canvas. The shape is marked on the canvas (and all parent canvases) associated with this facet, ensuring that changes to this facet are reflected across all appropriate canvases.

EXCEPTIONS

kODErrFacetNotFound
The requested facet was not found.
kODErrInvalidFacet
The specified facet is not an embedded facet of this facet.

SEE ALSO
The ODCanvas::Invalidate method (page 75).
The ODFacet::Validate method (page 258).
The ODFrame::Invalidate method (page 325).
Listing 2-23 on page 74 in OpenDoc Cookbook.
"Invalidating and Validating Your Content" on page 160 in OpenDoc Programmer's Guide.
"Drawing When a Part is Scrolled" on page 161 in OpenDoc Programmer's Guide.
"Drawing to an Offscreen Canvas" on page 168 in OpenDoc Programmer's Guide.